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IMPORTANT ! 



DUPLICATE 

THIS 
DISKETTE 
BEFORE 

USING 

THIS 
PROGRAM ! 



This APX diskette is unnotched to protect the software against 
accidental erasurei However, this protection also prevents a program 
from storing information on the diskette. The program you've 
purchased involves storing information. Therefore, before you can use 
the program, you must duplicate the contents of the diskette onto a 
notched diskette that doesn't have a write-protect tab covering the 
notch. 

• 

To duplicate the diskette, call the Disk Operating System (DOS) menu 
and select option J* Duplicate Disk* You can use this option with a 
single disk drive by manually swapping source (the APX diskette) and 
destination (a notched diskette) until the duplication process is 
complete* You can also use this option with multiple disk drive 
systems by inserting source and destination diskettes in two separate 
drives and letting the duplication process proceed automatically* 
(Note* This option copies sector by sector. Therefore* when the 
duplication is complete, any files previously stored on the 
destination diskette will have been destroyed*) 
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OVERVIEW 

FIX lets an advanced programmer get directly at several important areas of a diskette* 
Depending on the circumstances, FIX can sometimes help you recover some or all of your files 
from a "crashed" diskette* FIX lets you: (1) display directory entries, so that you know the 
exact entry for each file? (2) modify directory entries, so that you can control directory 
information; (3) trace sector chains through a file, looking for the end of the file or for a 
bad sector, so that you can verify the structure of a file} (4) check the allocation map, so 
that you can recover misallocated sectors? (5) modify sector links, so that you can control 
the file number, sector byte count, and forward sector pointer for any sector on the diskette 
and (6) edit actual sector data* 

This utility program is for an advanced systems programmer only* Its use requires a detailed 
understanding of disk structure* 

REQUIRED ACCESSORIES 
24K RAM 

ATARI 810 Disk Drive 



GETTING STARTED 

1* Turn on your disk drive, insert the DISK FIXER diskette, and power up your computer* 
2* When the READY prompt displays, type DOS to call up the menu* 
3* Enter menu selection L (Binary Load)* 

4* To the LOAD FROM WHAT FILE? prompt, enter FIXDMP and press the RETURN key* The file will 
load into RAM and start. 





I 
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I* INTRODUCTION TO FIX 



FIX is an assembly language utility to examine and Modify disk 
files* All nuMbers output by and entered to FIX are hexidecimal * 
You can use the CONTROL- I key to start and stop the data display 
on the screen* 



II* FILE STRUCTURE 



Diskettes are divided into blocks of data called sectors* 
Diskettes for the ATARI 810 Disk Drive have 720 sectors of 128 
bytes* Diskettes for the ATARI 815 Dual Disk Drive have 720 
sectors of 256 bytes* Diskettes have four parts: 

1 ♦ BIT MAP* The bit Map contains information on the status 
of each sector* By examining the bit map* the File Manager 
can determine if a sector has been allocated tin use) or 
not (free)* 

2* DIRECTORY ♦ The directory sectors contain information on 
the names* location* length* and status of the files on a 
diskette ♦ 

3* BOOT SECTORS ♦ Each diskette contains one or three 
sectors reserved for information read on power-up* These 
sectors are normally inaccessible to the user when using 
the File Manager* All 9/2^/79 DOS diskettes use sector one 
for the boot* All DOS II 2S or 2D diskettes use sectors one 
through three* 

^* DATA SECTORS ♦ The rest of the sectors are used to store 
the information in the files* Most of the bytes of a sector 
are dedicated to the actual file information* The last 
three bytes of every sector contain housekeeping 
information for the File Manager* 

FILES are made up of a DIRECTORY ENTRY and a set of one or more 
sectors* The sectors are usually contiguous ♦ but do not have to 
be* For a complete description of a directory entry* see section 
III* A* 
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III* MENU ITEMS 



FIX is a Menu-driven program* To execute coMnands^ type the 
letter in front of the co«M3nd listed in the displayed Menu (see 
Figure 1 ) ♦ You needn't press the RETURN key? FIX automatically 
accepts your cotiftsrid* and it replies with the pronpt for that 
coMMand* If you inadvertently type the wrong com wand* press the 
EiREAK key to abort the conhand* 

AJ Directory Entr ies 

This menu item displays the entries in the directory* Figure 2 
shows the user requesting FIX to display the first eight (hex) 
entries* Notice that the entries start with zero* The directory 
nay contain a m a x i m u m of 6^ files* Single entries May be 
displayed by siMply typing the file nunber and pressing the 
RETURN key* 

The leftMost coluMn gives the file nunber of each file 
displayed* The next coluMn contains the file naMe and extender* 
Notice that the period is oMitted in the file naMe* The next 
coluMn* labeled FSEC* is the first sector in the file* The #SEC 
coluMn lists the nunber of sectors in the file* Both nuMbers are 
hex i dec i Mai ♦ 

The last coluMn* DL* notes the status of the file* Notice in 
Figure 2 that file 3 (FIX6) has a D ♦ Meaning the file has been 
deleted froM the directory* Because it is the first available 
"hole 11 ♦ the next file created will occupy its directory entry* 
File 3 ( MYF'ROG ♦ BAS ) has an L* indicating the file is locked* 

Files 5-8 contain no directory entries* 



Bt Trace Sector Chair. 

This Menu iteM verifies the structure of a file* It traces the 
file through all its sectors until it hits 3n end-of-file or a 
bad link* A link is a pointer to the next sector of a file* A 
bad link is a link to a sector belonging to another file* An 
end-of-file is a link pointing to sector 0* 

Figure 3 shows the sector chain for the sMall BASIC file 
MYPROG ♦ BAS ♦ Notice we're tracing file nuMber 3* The file nunber 
is the entry nuMber into the directory* 



FIX Reference Manual 2*0 



Column BS has two different Meanings * depending on the DOS that 
created the file* The 9/2^/7? DOS A used this number as the 
relative sector number* For the first sector in a file* this 
should be 1* Subsequent sectors should add 1 to this number* If 
you notice that numbers are skipped* this May indicate that the 
links in your file Might be bad* The last sector's BS is the 
nuMber of bytes in the sector* 

For DOS II* the BS indicates the number of bytes in each sector* 
Most sectors contain *7D bytes (128-byte* single-density 
diskette) or $FD bytes (256-hyte* double-density diskette)* The 
last sector in a file is usually less than the above numbers* 

Appending one file to another will cause the byte count in the 
sector between the appended portions to be less than full* It is 
therefore possible to have partially filled sectors in the 
Middle of a file* 

Column FP is the forward pointer* This is the link to the next 
sector of the file* Files on newly formatted diskettes tend to 
be linked sequentially* Files on diskettes with several files 
that have been deleted tend to becoMe fractured, Meaning that 
the files tend not to be linked sequentially* In other words, 
the sectors are not physically cont inguous ♦ 

C: Modify Directory Entry 

Use this Menu iteM to Make changes to the diskette's directory* 
Enter the file number of the entry you wish to change and press 
the RETURN key* 

Figure 4 shows the user is Making a change to directory entry 3* 
FIX has printed the directory iteM and positioned the cursor to 
the file nane« 

At this point* you can edit the file rone, the starting sector 
number* the number of sectors, or the status of the file* By 
inserting or deleting the D* you can delete or reinstate the 
file* Ely adding or deleting the L* you can lock or unlock the 
file* See section III* A for the meaning of the rest of the 
information on the line* 

If you wish to have FIX update the entry* then press the RETURN 

key* If you don't want the entry updated, then press the BREAK 

■ 



3- 
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DJ Check Allocation hap 

This Menu iten can recover sectors that have become 
Misal located ♦ To run it, type D* FIX automatically starts Making 
its own bit Map ♦ It will link through all the files and Mark all 
the sectors in use and those that are free* FIX then compares 
its bit Map to the bit Map on the diskette* All sectors that 
should be free but aren't are printed as "MARKED IN USE" ♦ All 
sectors that are really allocated to a file but aren't in the 
diskette's bit Map are Marked "FREE" ♦ Sectors that are correctly 
allocated aren't printed* 

After FIX has checked all the sectors* it will exit back to the 
Menu if all sectors are correct* If some sectors are 
Misal located ♦ it will ask you if you want to write its correct 
copy to the diskette* Type Y to do so* If you don't want the 
corrected bit Map to be written to the disk* then press the 
RETURN key* 

Figure 5 shows the result of a D coMMand* Notice that we had a 
bad link in file 0 (the first file)* This will usually cause an 
error code 16^ to display when you atteMpt to read the file* We 
would probably want to trace its sector chain (E; coMMand) to 
find the bad link* Our bit Map seeMS also to be slightly 
Mangled* so we would type Y to rewrite our new bit Map* 



Et Modify Sector Link 

You May have discovered that soMe of your sector links have been 
altered incorrectly* This Menu iteM allows you to change the 
links in the sectors on the diskette* After you type E ♦ FIX 
proMpts you to enter the sector nuMher to Modify* Enter the hex 
sector nuMber and press the RETURN key* 

FIX then prints the sector link inf or Mat ion froM the sector on 
the diskette* FIX positions the cursor on the line* Using the 
cursor control keys* you can alter the file number this sector 
is allocated to* the nuMber of bytes in this sector of the file* 
and the forward pointer* Typing an E to the right of the forward 
pointer will Mark this sector as end-of-f i le ♦ 

To tell FIX to write out the updated inf or Mation to the sector* 
press the RETURN key* If you realize you've made an error in 
trying to Modify this sector* first position the cursor below 
the line and then press the RETURN key* FIX will then redisplay 
the line* Press the RETURN key to exit* 

See section III*B for More inf or Mation on the sector link 
disp lay ♦ 
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FJ Set Drive Nun ber 

This nenu item sets the disk drive number « Type the disk drive 
number (1 - 8) and press the RETURN key* Figure 7 shows a user 
setting the disk drive number to 1 (FIX defaults to disk drive 1 
upon loading ) ♦ 



G: Exit to DOS 
This item causes a return to DOS ♦ 



Hi Dump Sectors 

This item lets you examine sectors on the diskette* To look at a 
single sector ♦ type the sector number (in hex) and press the 
RETURN key* To look at several contiguous sectors* type the 
starting sector* a comma* and then the ending sector, then press 
the RETURN key* As the information scrolls up the screen* use 
CTRL-1 to stop and resume the display (that is* hold down the 
CTRL key while pressing 1)* 

Figure 8 shows a typical dump of a 128-byte sector* The sector 
links for this sector are at the top of the screen (see section 
III*B)* The bytes in the sector are displayed in an 8-by-16 
matrix in both hex and ATASCII* The leftmost column is the 
position of the next column's byte in the sector* 
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IS Edit Sector 

This lten lets you examine and Modify a single sector on the 
diskette* In response to the proMpt* enter the sector number (in 
hex) and press the RETURN key 4 FIX will then display a full 
128-byte sector or the first half of a 256-byte sector similarly 
to the H option* To edit the sector* position the cursor on the 
line to be Modified* Notice that in the left-hand column the hex 
position of the byte in the next coIumti is displayed* Use these 
numbers to guide you in editing lines* You can edit only the hex 
bytes in the sector display* The ASCII characters are for 
reference only* 

After editing a line* press the RETURN key* FIX will then 
redisplay the sector (or sector part) with your Modifications* 
After you've finished editing* press the BREAK key* FIX will ask 
you if you wish to write the Modified sector to the diskette* To 
do so* press the Y key* Press any other key to cause FIX to ask 
you if you wish to exit* Press the Y key to return to the Menu 
without changing this sector on the diskette* Or* to cause FIX 
to ask you whether you want to write this sector to another 
sector* press any key other than Y* Then type in the number of 
the sector to which you want FIX to write this sector* Or* press 
the RETURN key to redisplay the proMpt to exit* 

Editing a 256-byte sector differs slightly froM editing a 
128-byte sector* described above* FIX displays the first half of 
the sector (bytes 0 - 7F hex)* You edit this part as described* 
Pressing the BREAK key after editing the first part of the 
sector lets you edit the second part (bytes 80 - FF ) ♦ You then 
press the BREAK key again for FIX to ask you if you want to 
write the sector* exit* and so on* 

Figure 9 shows the editing of sector 5* The display resenbles 
that for the H coMMand* We Modify sector 5 and then press the 
BREAK key* We respond to the two prompts by pressing the RETURN 
key* because we wish to write our edited sector to sector 8* We 
then type 8 <RETURN> and FIX writes the edited sector to sector 
8* 
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IV* ERROR CODES AND RECOVERY 



ERROR # DESCRIPTION 
**************** 

128 BREAK KEY ABORT 

This is caused by pressing the BREAK key* 

129 IOCB ALREADY OPEN 

The IOCB is already open* 

Recovery ♦ You can CLOSE the IOCB and reOPEN it* You can use 
the current IOCB ♦ You May want to check to see why the IOCB is 
OPEN* 

130 NON EXISTENT DEVICE 

You have tried to access a device not in the handler table; 
i*e** the device is undefined* The handler May be loaded in 
Memory but not initialized* This error May occur when trying to 
access the ATARI 850 Interface Module without running the RS232 
AUTORUN*SYS file* 

Recovery ♦ Check your I/O coMMand for the correct device* or 
load and initialize the correct handler* 

131 IOCB WRITE ONLY ERROR 

You have atteMpted to read froM a file opened for write only* 
Recovery * Open the file for read or read/write (update Mode)* 

132 ILLEGAL HANDLER COMMAND 

This is a CIO error code* The coMMand code passed to the device 
handler is illegal* The coMMand is either less than or equal to 
2 or is a special coMMand to a handler that hasn't iMpleMented 
any special coMMands* 

Recovery ♦ Check your XIQ or IOCB coMMand code for illegal code* 

133 DEVICE/FILE NOT OPEN 

Device or file not open* You haven't OPENed this file or device* 
Recovery * Check your OPEN statenent or file I/O stateMent for 
the wrong file specification* 

13^ INVALID IOCB NUMBER 

You've tried to use an illegal IOCB index* For BASIC ♦ the range 
is 1 -7* BASIC doesn't allow use of IOCB 0* The Assembler 
Editor Cartridge requires the IOCB index to be a Multiple of 16 
and to be less than 128* 

135 IOCB WRITE ONLY ERROR 
You've tried to write to a device/file that is OPEN for read 
only* Recovery * You could open the file for write or for 
read/write* 

136 END OF FILE 
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Your input file is at enci-of -f i 1 e ♦ No More data is in the file* 

137 TRUNCATED RECORD 

This error typically occurs when the record you ' re reading is 
larger than the fiaxiMUM record size specified in the call to 
CIO* E'.ASIC's mbkimum record size is 119 bytes* 
Recovery ♦ You probably are trying to use an INPUT 
(record-oriented) command on a file that was created using PUT 
< byte-or iented ) commands ♦ 

Records in a file are delimited by EOL (End Of Line) characters 
($9B)* Files created using PUTs have no EOL unless the bytes you 
output have a $9B* Trying to read a PUT file with record I/O way 
cause the DOS to read a record the size of the file* The DOS 
will then generate this error* Try reading the file using PUT 
statements* 

This error nay also occur when ENTERing a BASIC program created 
using SAVE* Try LOADing the program* 

138 DEVICE TIMEOUT 

A command was sent by the computer to a device over the serial 
bus* The device didn't respond within the period set by the 
Operating System (OS) for that particular device command* This 
error can be caused in a couple of ways* 

1* The device number may be wrong* For example* the command 

OPEN #3*4* 0 * M D3*MYPR0G" 

could cause this error to display if disk drive 3 isn't 
connected to the computer* turned on* or present* 

2* The disk drive may be present but is unable to execute the 
command in the proper period of time* 

Recovery ♦ To recover from error case 1* examine the 
connections between the disk drive and the computer to make sure 
they're properly secured* Check the drive to make sure it's 
powered on and set for the correct drive number* Check your I/O 
command for the correct drive number* Retry the command* If you 
get this error again* try the recovery technique for the second 
error case* The second type of timeout error is caused by an 
interaction between the OS and the disk drive* DOS 9/24/79's 
timeout value was set too low for all possible cases of disk 
operations* The disk may have had some trouble executing the 
command in the short period allowed by the operating system* DOS 
II doesn't have this problem* This type of timeout error is 
intermittent* You should be able to retry the operation and 
succeed* If this error occurs more than a few times* the device 
may need repair* 
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139 DEVICE NAK 

This is a catch-all error code* The device nay have received a 
valid cownand ♦ but can't execute it because of bad 

parameters — for example* trying to read an unaddr essable sector ♦ 
such as sector ()♦ Or * the device may have received a garbled 
command or dat3 frame from the computer* 

Recovery ♦ Check your I/O command for illegal parameters* 

140 SERIAL FRAME ERROR 

Bit 7 of SKSTAT in POKEY is set* This means communications from 
the device to the computer are garbled* Specifically* POKEY 
detected missing or extra bits in a byte received on the serial 
data bus* 

141 CURSOR OUTRANGE 

Your cursor is out of range for this particular graphics mode* 

142 SERIAL OVERRUN 

Bit 5 of SKSTAT in POKEY is set* The computer didn't respond 
fast enough to a serial bus input interrupt* POKEY received 
another 8-bit word on the serial bus before the computer could 
process the previous word received* 

Recovery * This is a rare error* If it recurs* you should have 
your computer serviced* 

143 CHECKSUM ERROR 

Serial bus communications are confused* The checksum sent by the 
device isn't the same as that calculated from the frame received 
by the computer* 

Recovery ♦ You can't do much about this* It could be a hardware 
or a software problem in the device/computer* 

144 DEVICE DONE ERROR 

The device can't execute a valid command* This error has two 

causes* Usually it means you've tried to write to a 

wr ite-pr otected device or diskette* This is easily corrected by 

removing the diskette protect tab or by turning off the 

wr ite-pr otect switch on the ATARI 815* 

The second reason for this error appears unknown at this point* 

The disk drive is unable to read/write the sector requested or 

the cassette is set at the wrong baud rate* 

Recovery ♦ Remove the wr ite-pr otect tab or turn off the 

wr ite-protect switch* If the diskette wasn't wr ite-pr otected ♦ 

you might have problems with the diskette media* (I don't know 

how to recover on cassette*) 
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145 READ AFTER WRITE COMPARE ERROR 

You've tried to open the SCREEN EDITOR with an illegal graphics 
Mode number ♦ 

Recovers ♦ Check GRAPHICS mode call or the AUX2 byte in the 
IOCB* 

146 FUNCTION NOT IMPLEMENTED 

Function not implemented in handler* e*g** trying to PUT to the 
keyboard or issuing special commands to the keyboard* 
Recovery ♦ Check your I/O command for the right command to the 
correct device* 

147 NOT ENOUGH RAM FOR SELECTED GRAPHICS MODE 

You don't have sufficient RAM installed for the selected 
graphics mode* 

Recovers « Add more memory or use a smaller graphics mode* 

160 DRIVE NUMBER ERROR 

You specified an out-of ~r ange drive (not 1 - 8) or you haven't 
allocated a buffer for this drive* 

Recover y * Check your file specification or byte 1802 ($710)* 

161 TOO MANY OPEN FILES 

You don't have any free sector buffers to use on another file* 
Recovery ♦ You may have up to S open files* Check location 1801 
($709) for the number of sector buffers allocated* 

162 DISK FULL 

You don't have any more free sectors on this diskette* This 
error occurs when writing to a full diskette* 

Re cov ery * Use a different diskette with free sectors* Use the 

«» « ■ >— wmm m* 

D option on FIX to see if you've misallocated sectors* At 

present* you can't recover from this error during program 
execution ♦ 

163 FATAL SYSTEM I/O ERROR 

This error code means the File Manager has a bug in it* If you 
get this error* please report it to CUSTOMER SERVICE 
(800/538-8547* or 800/672-1430 for calls within California)* 

164 FILE NUME'.ER MISMATCH 

The structure of the file is damaged* One of the file links 
points to a sector allocated to another file* 

Recovery * Use B and E FIX commands to fix up the file links* 

You can't recover from this error during program execution* 

165 FILENAME ERROR 

Your file specification has illegal characters in it* Legal 
characters are alphanumer ics * * ♦ and ?♦ 

Recovery * Check your file specification and remove illegal 
characters ♦ 
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166 



POINT DATA LENGTH 

The byte count in the POINT call was greater than 125 
(single-density) or 253 (double-density) ♦ 
Recovery ♦ Check POINT statement parameters* 



167 FILE LOCKED 

You've tried to access a locked file* 
Recovery ♦ Unlock the file* 

168 DEVICE COMMAND INVALID 

This probably Means the device didn't recognize the command* 

Recover y * ????? 

169 DIRECTORY FULL 

You don't have any free entries in the directory* 
Recovery * See A and C FIX commands* 

170 FILE NOT FOUND 

You've tried to access a file that doesn't exist in the 
diskette ' s directory ♦ 

R ecovery ♦ Usually you've Mistyped the file specification* 

Using the DOS A coMnand* look at the directory for the correct 



171 POINT INVALID 

You've probably tried to POINT to a byte or record beyond the 
end of the file* 

Recovery ♦ Check the size of the file against the POINT value* 



172 ILLEGAL APPEND 

You've tried to OPEN a DOS I file for append using DOS II* DOS 
II can't append to DOS I files* 

Recovery * Copy the DOS I file to a DOS II diskette* using DOS 
II* 

173 BAD SECTORS AT FORMAT 
The disk controller detected bad sectors while formatting a 
diskette ♦ 

Recovery ♦ Throw away the diskette and use another* If you 
can't format a diskette* the disk drive night need repair* 



name ♦ 
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fixdump 2.0sd (c) atari 10/3/1980 

a: directory entries h: dump sectors 

b: trace sector chain i: edit sector 

c: modify directory entry 

d: check allocation map 

et modify sector link 

f: set drive number 

g: exit to dos 



SELECT ITEM OR RETURN FOR MENU 



Figure I* Disk Fixer Menu 



SELECT ITEM OR 
FIRST, LAST DIR 
0,8 

D# FILENAM 
DOS 
DUP 
FIX6 

03 MYPROG 

04 FIX6 
05 

0 6 ########### 

07 ##########* 

08 ##*######## 



00 
01 
02 



EXT 
SYS 
SYS 

BAS 



RETURN FOR MENU 
ENTRIES TO SHOW? 



FSEC 
0004 
002A 
0054 
007E 
0054 
00 00 
0000 
0 000 
0000 



#SEC DL 
0026 
002A 
002A 
0003 L 
0020 
0000 
00 00 
0000 
00 00 



D 
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Figure 2» Option A ♦ Directory of Entries 
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SELECT ITEM OR RETURN FOR MENU 
TRACE FROM WHAT DIR ENTRY? 

3 

0 3 MYPROG BAS 0 07E 0 0 03 L 
SECTOR 07Et F#»03, BS=7D, FP=07F 
SECTOR 07F: F#=03, BS=7D, FP=080 
SECTOR 060 : F#=03» BS»45, FP=000 E 

SELECT ITEM OR RETURN FOR MENU 



Figure 3. Option B« Tr3ce Sector Chain 
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WHICH ENTRY TO MODIFY? 

3 

D# FILENAM EXT FSEC #SEC DL 
03 MYPROG BAS 0 07E 0 0 03 L 



Figure A ♦ Option CI Modify Directory Entry 



SELECT ITEM OR RETURN FOR MENU 

BUILDING ALLOCATION MAP* . ♦ 

BAD LINK IN FILE #00 

SECTOR 001: F#=00, BS=0C, FP=203 

WAS MARKED IN USE 

SECTOR 004! F#=00, BS=7D, FP=005 
WAS MARKED FREE 

SECTOR 007: F*=00, BS=7D, FP=008 
WAS MARKED IN USE 

SECTOR 02A: F#=01, BS=7D, FP=02B 
WAS MARKED FREE 

SECTOR 02C: F#=01, BS=7D, FP=02D 
WAS MARKED FREE 

SECTOR 032: F*=01, BS=7D, FP=033 
WAS MARKED FREE 



Figure 5. Option D: Check Allocation Map 



FIX Reference Manual 2»0 



SELECT ITEM OR RETURN FOR MENU 
MODIFY LINK OF WHAT SECTOR? 
SO 

SECTOR 08 0 t F*«03, BS=45, FP=0 0 0 E 



Figure 6* Option EJ Modify Sector Link 



SELECT ITEM OF RETURN FOR MENU 

USE WHAT DRIVE NUMBER? 

1 

SELECT ITEM OR RETURN FOR MENU 



Figure 7» Option Ft Set Drive Number 
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FIX Reference Manual 2.0 



SECTOR 0 05 J F*=0 0, BS=7D, FF-0 06 
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SELECT ITEM OR RETURN FOR MENU 



Figure S. Option Hi Dump Sectors 
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FIX Reference Menus! 



SELECT ITEM OR RETURN FOR MENU 
ENTER HEX DISK SECTOR TO EDIT 

cr 

w 

SECTOR 0 05: F#=0 0, BS=7D, FP=0 06 
BYTE 
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TYPE BRK TO EXIT 

TYPE" "Y" TO WRITE SECTOR 
TYPE "Y" TO EXIT 

ENTER HEX SECTOR TO WRITE BUFFER TO 

8 



Figure 9* Option It Edit Sector 
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PROGRAM 

EXCHANGE 



P.O. Box 3705 
Santa Clara CA 95C55 







Review Form 



We" re interested in your experiences with APX programs 
and documentation, both favorable and unfavorable. 
Many of our authors are eager to improve their programs 
if they know what you want. And. of course, we want to 
know about any bugs that slipped by us, so that the 
author can fix them. We also want to know whether our 



instructions are meeting your needs. You are our best 
source for suggesting improvements! Please help us by 
taking a moment to fill in this review sheet. Fold the sheet 
in thirds and seal it so that the address on the bottom of 
the back becomes the envelope front. Thank you for 
helping us! 



1. 



.. an ■ r " ■ ■ ;.'f 1 ' ' ' ' — 1 '<" ■ "! n i l ' m i . i ,. n i ' ■ " " ' ■ 

2. If you have problems using the program, please describe them here. 



3. What do you especially like about this program? 



— — _ 1 — — 

4. What do you think the program's weaknesses are? 

11 11 ' 



5. How can the catalog description be more accurate or comprehensive? 



■ 



— 



5. On a scale of 1 to 10. 1 being "poor" and 10 being "excellent", please rate the following aspects of this program 



_ Easy to use 

_ User-oriented (e.g.. menus, prompts, clear language) 

_ Enjoyable 

m Seif-mstructive 

_ Useful (non-game programs) 

_ Imaginative graphics and sound 



7. Describe any technical errors you found in the user instructions (please give page numbers). 



8. What did you especially like about the user instructions? 



- 



9. What revisions or additions would improve these instructions? 



10. On a scale of 1 to 10, 1 representing "poor" and 10 representing "excellent", how would you rate the user 
instructions and why? 



11. Other comments about the program or user instructions: 



-rom 



STAMP 



ATARI Program Exchange 

P.O. Box 3705 

Santa Clara. CA 95055 



[seal here; 




Pr ogrsM and Manual Contents © 1982 ATARI, Inc* 

Copyright notice * On receipt of this computer program and associated documentation (the 
software), ATARI, Inc« grants you a nonexclusive license to execute the enclosed software* 
This software is copyrighted ♦ You are prohibited from reproducing, translating, or 
distributing this software in any unauthorized manner. 




Distributed By 



The ATARI Program Exchange 
P.O. Box 3705 
Santa Clara. CA 95055 

To request an APX Product Catalog, write to the address above, or call toll-free: 

800/538-1862 (outside California) 
800/672-1850 (within California) 

Or call our Sales number. 408/727-5603 



Trademarks of Atari 

The following are trademarks of Atari, Inc. 



ATARI® 
ATARI 400™ 
ATARI 800™ 
ATARI 410™ 
ATARI 810™ 
ATARI 820™ 
ATARI 822™ 
ATARI 825™ 
ATARI 830™ 
ATARI 850™ 



Home Computer 
Home Computer 
Program Recorder 
Disk Drive 
40-Coiumn Printer 
Thermal Printer 
80-Column Printer 
Acoustic Modem 
Interface Module 



Printed m U.S.A. 



IMPORTANT ! 



DUPLICATE 

THIS 
DISKETTE 
E-.EFORE 

USING 

THIS 
PROGRAM ! 



This APX diskette is unnotched to protect the software against 
accidental erasure. However* this protection also prevents a program 
from storing information on the diskette* The program you've 
purchased involves storing information* Therefore, before you can use 
the program, you must duplicate the contents of the diskette onto a 
notched diskette that doesn't have a write-protect tab covering the 
notch* 

To duplicate the diskette, call the Disk Operating System (DOS) menu 
and select option J, Duplicate Disk* You can use this option with a 
single disk drive by manually swapping source (the APX diskette) and 
destination (a notched diskette) until the duplication process is 
complete* You can also use this option with multiple disk drive 
systems by inserting source and destination diskettes in two separate 
drives and letting the duplication process proceed automatically* 
(Note* This option copies sector by sector* Therefore, when the 
duplication is complete, any files previously stored on the 
destination diskette will have been destroyed*) 
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OVERVIEW 

With LOAD 'N GO you can automatically start a BASIC program at the time you power up your 
computer, approximating a turn-key system (that is, a computer system dedicated to a 
single application)* To set up the automatic program execution, you run the LOAD 'N GO 
program once* LOAD 'N GO asks you to enter a RUN or LOAD command for the BASIC program 
you want executed automatically* It then creates an AUTORUN*SYS file that executes your 
program whenever you turn on your computer and boot the program diskette* 

Here are a few of LOAD 'N GO'S many uses* 

(1) If you have a diskette with several programs that you routinely use at different 
times, you can write a menu display program for these files and then have LOAD 'N GO 
automatically display the menu upon powerup* Such a system masks the usual steps for 
loading in and executing a program and thus streamlines routine activities* Using 
LOAD 'N GO in this way also makes your programs easier for non-programmers to use* 

(2) You can use LOAD 'N GO to autoexecute a particular program on a diskette so that 
novice computer users need only insert your program diskette, turn on the disk 
drive, and power up the computer to begin using your program* 

(3) You can use LOAD 'N GO to perform initialization chores, such as changing the 
video screen margins or color, or initializing peripherals (e*g*, controller jacks)* 

(4) You can protect other files on a diskette from being accessed by users if you 
include POKE commands in your BASIC program to disable the BREAK key and to change 
the SYSTEM RESET key so that pressing it causes a cold start* You then use LOAD 'N 
GO to autoexecute your program* The sample application at the end of these 
instructions shows one method for obtaining such protection* 

REQUIRED ACCESSORIES 
16K RAM 

ATARI BASIC Language Cartridge 
ATARI 810 Disk Drive 



GETTIMG STARTED 



t« Insert the ATARI BASIC Language Cartridge in the (Left Cartridge) slot of your 
computer ♦ 

2* Turn on your disk drive and insert the LOAD 'N GO diskette* 
3* Power up your computer and turn on your video screen* 

4« At the READY prompt, type RUN "DJLOADGO" and press the RETURN key* If you're using 
more than one disk drive, remember to follow the device initial (D) with the number of 
the drive containing the diskette (e*g** RUN ,, D2:LOADGO H for disk drive two)* LOAD 'N GO 
will load into RAM and start* 



3 



'3SE GO 



The following message and prompt then display! 

AUTORUN BUILD PROGRAM FOR BASIC 
DOS VERSION 2.X 

ENTER COMMAND ? 

Enter the RUN or LOAD command to call the BASIC program you want automatically executed 
and press the RETURN key* For most applications, you'll want to use a RUN command rather 
than a LOAD command* For example, to boot automatically a program named CHECKINGS AS, 
answer the prompt with RUN "DICHECEING.BAS" ORETURN>« ( Important Note * Remember to end 
the command with the closing quotation mark* Otherwise, an ERROR 170 — File Not 
Found — message will display when you try to autoexecute your program*) Your command can 
be as long as 12S characters* 

After you enter this information, LOAD 'N GO creates an AUTORUN*SYS file on the diskette 
in disk drive one* Therefore, how you answer this prompt depends in part on how many disk 
drives you use* 

If vou use one disk drive * 

If you use only one disk drive, this AUTORUN ♦SYS file must be on the same diskette 

as the program to be run automatically* Therefore, after loading LOAD 'N GO into 

RAM, remove the LOAD 'N GO diskette and insert the diskette containing your program 

to be run automatically* Then enter the RUN or LOAD command in response to the 

prompt and press the RETURN key (e.g*, RUN u D*CHECKING*EAS n <CRETURN»* LOAD 'N GO 

will create the AUTORUN*SYS file on the diskette containing your program* 

If vou have more than one disk drive * 

Decide which disk drive you'll routinely use to insert your program diskette and 
then specify that drive number in your RUN or LOAD command* For example, if you 
always intend to insert your program diskette in disk drive two, then enter that 
device initial and number in front of the file name <e*g*, RUN ,, D2:CHECKING*BAS" 
<RETURN». LOAD N' GO creates the AUTORUN,SYS file on the diskette in disk drive 
one, but your command specifies which drive contains the program to be autoexecuted* 

Naming * Because LOAD 'N GO creates an AUTORUN*SYS file, you can't have another 
AUTORUN*SYS file on the diskette in disk drive one* If an AUTORUN*SYS file is on the 
diskette, LOAD 'N GO will replace it with its own AUTORUN*SYS file. 



AUTOMATIC PROGRAM LOADING 



Once you use LOAD 'N GO to designate the program you want executed upon powering up* you 
don't need to use LOAD 'N GO anymore for that particular application* From then on, you 
simply insert the diskette containing the AUTORUN*SYS file in disk drive one (and your 
program diskette in the specified disk drive, if your program is on another diskette) and 
power up your computer* The program will autoexecute* 

To stop the automatic loading of a program, you can either delete the AUTORUN*SYS file 
using DOS option D (DELETE FILE), or you can rerun LOAD 'N GO and specify a different 
file to be loaded from the same diskette. The new AUTORUN*SYS file created will replace 
the former one* 

EXPERIMENT WITH LOAD 'N GO 

You can use other BASIC commands with LOAD 'N GO* Because BASIC resumes control at some 
points, results aren't always predictable* Experiment to see what else you can do with 
LOAD H GO! 
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SAMPLE APPLICATION 



Supp-.se you want to perform the following activities each time you power up your computer 
with a particular diskette: 

(1) disable the BREAK key 

(2) reset the SYSTEM RESET key to cause a cold start 

(3> load in and start a program (the program asks the user to input a number; it 
then generates that number of random notes, each note for a random length of time) 

You can use LOAD 'II GO to autoexecute this program. The program itself looks like this! 



1 n 

,u w 

2 0 
30 
^0 

50 

6 0 

7 O 

.• 



REM LOAD ' N GO DEMO 

REM TURN SYSTEM RESET INTO RE-BOOT MECHANISM 
POKE 58 0 t i 

rem" disable break key 

m .* v > v' W v v vv V/ v/ v/ W V' H ' V' W W 



r;> nr m 



c; o -r -7 .a A. jO, 



NUMBER OF NOTES (0 TO EXIT ) "I t INPUT N 



8 0 POKE 16 t 6^ t POKE 

9 0 REM MAIN PROGRAM LOOP 

10 0 REM # x'. & * * * * va x x >k « x< x & 
110 PRINT CHR*< 125) * "INPUT 
12 0 IF N=Q THEN 20 0 

ISO FOR I«l TG N 

1*0 SOUND 0, INT <RHDC0>*255> ,10,8 

1 5 0 FOR TD* 1 TO INT ( RND ( 0 ) * 1 0 0): NEXT TD 

160 NEXT I 

17 0 SOUND 0,0,0,0 

1 P, 0 G O TO 11 0 

?0 0 REM RESET BREAK AND SYSTEM RESET TO NORMAL 

220 POKE 580,0:POKE 16, 192! POKE 53771,192 
22 0 REM THAT'S ALL FOLKS' 

240 END 

CRtmembtr that the computer re-enables the BREAK key after any serial bus I/O operation, 
or after changing graphics modes, so you'll need to include the POKE commands m your 
programs at appropriate points*) 

You save this program on the diskette in disk drive one and name the file NOTES »E AS The 
command is SAVE H 0:KCTES.EAS tt . Next, you load the LOAD 'N GO program into RAM as 
dac _ ibed in the GETTING STARTED section and answer the prompt as follows: 



._. L .... 



AUTORUN BUILD PROGRAM FOR BASIC 
DOS VERSION 2.X 



ENTER COMMAND ?RUN "DENOTES* & AS" <RETURN> 

LOAD 'N GO then creates an AUTORUN*SYS file on the diskette, which automatically executes 
the commands in your NOTES^BAS file* That is, whenever you power up your computer with 
this diskette in disk drive one, the program NOTES*BAS automatically executes* 



• 



-7- 



Limited Warranty on Media and Hardware Accessories. Atari. I nc ( Atari") warrants to the original 
consumer purchaser that the media on which APX Computer Programs are recorded and any 
hardware accessories sold by APX shall be free from defects in material or workmanship for a 
period of thirty (30) days from the date of purchase. If you discover such a defect within the 30-day 
period, call APX for a return authorization number, and then return the product to APX along with 
proof of purchase date. We will repair or replace the product at our option. If you ship an APX 
product for in-warranty service, we suggest you package it securely with the problem indicated in 
writing and insure it for value, as Atari assumes no liability for loss or damage incurred during 
shipment. 

This warranty shall not apply if the APX product has been damaged by accident, unreasonable 
use, use with any non- ATARI products, unauthorized service, or by other causes unrelated to 
defective materials or workmanship. 

Any applicable implied warranties, including warranties of merchantability and fitness for a 
particular purpose, are also limited to thirty (30) days from the date of purchase. Consequential or 
incidental damages resulting from a breach of any applicable express or implied warranties are 
hereby excluded. 

The provisions of the foregoing warranty are valid in the U.S. only. This warranty gives you 
specific legal rights and you may also have other rights which vary from state to state. Some states 
do not allow limitations on how long an implied warranty lasts, and/or do not allow the exclusion of 
incidental or consequential damages, so the above limitations and exclusions may not apply to 
you. 

Disclaimer of Warranty on APX Computer Programs. Most APX Computer Programs have been 
written by people not employed by Atari. The programs we select for APX offer something of value 
that we want to make available to ATARI Home Computer owners. In order to economically offer 
these programs to the widest number of people, APX Computer Programs are not rigorously 
tested by Atari and are sold on an "as is" basis without warranty of any kind. Any statements 
concerning the capabilities or utility of APX Computer Programs are not to be construed as 
express or implied warranties. 

Atari shall have no liability or responsibility to the original consumer purchaser or any other 
person or entity with respect to any claim, loss, liability, or damage caused or alleged to be caused 
directly or indirectly by APX Computer Programs. This disclaimer includes, but is not limited to, 
any interruption of services, loss of business or anticipatory profits, and/or incidental or 
consequential damages resulting from the purchase, use, or operation of APX Computer 
Programs. 

Some states do not allow the limitation or exclusion of implied warranties or of incidental or 
consequential damages, so the above limitations or exclusions concerning APX Computer 
Programs may not apply to you. 



For the complete list of current 
APX programs, ask your ATARI retailer 
for the APX Product Catalog 



# 
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Review Form 



We're interested in your experiences with APX programs 
and documentation, both favorable and unfavorable. 
Many of our authors are eager to improve their programs 
if they know what you want. And, of course, we want to 
know about any bugs that slipped by us, so that the 
author can fix them. We also want to know whether our 

1. Name and APX number of program. 



instructions are meeting your needs. You are our best 
source for suggesting improvements! Please help us by 
taking a moment to fill in this review sheet. Fold the sheet 
in thirds and seal it so that the address on the bottom of 
the back becomes the envelope front. Thank you for 
helping us! 



2. If you have problems using the program, please describe them here. 



3. What do you especially like about this program? 



4. What do you think the program's weaknesses are? 



5. How can the catalog description be more accurate or comprehensive? 




5. On a scale of 1 to 10. 1 being "poor" and 10 being "excellent", please rate the following aspects of this program: 



Easy to use 

User-oriented (e.g.. menus, prompts, clear language) 

Enjoyable 

Self-instructive 

Useful (non-game programs) 

Imaginative graphics and sound 



7. Describe any technical errors you found in the user instructions (please give page numbers). 



8. What did you especially like about the user instructions? 



9. What revisions or additions would improve these instructions? 
— — i — i 



10. On a scale of 1 to 10, 1 representing ,4 poor" and 10 representing "excellent", how would you rate the user 
instructions and why? 



11. Other comments about the program or user instructions: 



TOTTJ 



— — 



STAMP 



ATARI Program Exchange 

P.O. Box 3705 

Santa Clara. CA 95055 



[seal here; 



